Skip to content

Add Windows troubleshooting for SSH agent conflicts.#42822

Open
BlackDoubleB wants to merge 3 commits intogithub:mainfrom
BlackDoubleB:patch-1
Open

Add Windows troubleshooting for SSH agent conflicts.#42822
BlackDoubleB wants to merge 3 commits intogithub:mainfrom
BlackDoubleB:patch-1

Conversation

@BlackDoubleB
Copy link

Add guidance for resolving passphrase prompts caused by Git for Windows using a different SSH client than the Windows ssh-agent.

Why

Users on Windows may configure ssh-agent in PowerShell but still be prompted for a passphrase when using Git operations. This can happen when Git for Windows uses its bundled SSH client, which cannot access the Windows ssh-agent service.

What's being changed

  • Add a Windows TIP explaining the Git for Windows vs Windows OpenSSH mismatch.
  • Include a command to configure Git to use the Windows system OpenSSH client:
    • git config --global core.sshCommand "C:/Windows/System32/OpenSSH/ssh.exe"

Check off the following

  • I have reviewed the technical accuracy of the content in this PR.

Add guidance for resolving passphrase prompts caused by Git for Windows using a different SSH client than the Windows ssh-agent.
@welcome
Copy link

welcome bot commented Feb 7, 2026

Thanks for opening this pull request! A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

@github-actions github-actions bot added the triage Do not begin working on this issue until triaged by the team label Feb 7, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Feb 7, 2026

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md fpt
ghec
ghes@ 3.19 3.18 3.17 3.16 3.15 3.14
fpt
ghec
ghes@ 3.19 3.18 3.17 3.16 3.15 3.14

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

@BlackDoubleB BlackDoubleB changed the title Add Windows troubleshooting for SSH agent conflicts Add Windows troubleshooting for SSH agent conflicts. Feb 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

triage Do not begin working on this issue until triaged by the team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant